Skip to main content

ExpandTo

Returns a new range that goes beyond the specified range in any direction and spans a different range. The current range has not changed.

Syntax

expression.ExpandTo(oRange);

expression - A variable that represents a ApiRange class.

Parameters

NameRequired/OptionalData typeDefaultDescription
oRangeRequiredApiRangeThe range that will be expanded.

Returns

ApiRange | null

Example

This example returns a new range that goes beyond the specified range in any direction and spans a different range.

let doc = Api.GetDocument();
let paragraph = doc.GetElement(0);
paragraph.AddText("Lorem ipsum dolor sit amet,");
paragraph.AddText(" consectetuer adipiscing elit,");
paragraph.AddText(" sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.");
let rangeFirst = doc.GetRange(0, 22);
let rangeSecond = doc.GetRange(49, 123);
let range = rangeFirst.ExpandTo(rangeSecond);
range.SetItalic(true);